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(57) Abstract 



A computer-based method for assisting a user in making 
decisions in the process of completing a task is shown and 
described. The method of the system includes providing a set of 
questions for completing the task, asking the user a first question 
from the set, and providing a choice of answers to the first 
question. The system also provides advice from its knowledge 
base for deciding which of the answers to the first question 
to select. The choice of answer, however, remains under the 
control of the user, who can exercise professional judgment 
based on the user's expertise and the advice provided by the 
decision management system. The method continues by asking 
following questions, with the following questions, answers and 
advice influenced by the user's previous answers. Throughout 
the decision-making process, the user retains control of the 
answers if so desired, with the system providing advice from 
its knowledge base. The system is particularly suited for 
document assembly in allowing an experienced lawyer or other 
professional to determine what provisions are suitable for a 
document to be built from information and judgments provided 
by the lawyer or other professional and the knowledge base of 
the system. The system also includes an authoring program for 
preparing applications that run on the system. Using an intuitive 
program block approach of the authoring tool, an author can 
construct an application by placing questions, answer choices, 
advice and textual and logical provisions in named program 
blocks. The author then assembles and arranges these blocks to 
build a desired application program. The logic of the application 
is easily accessible and simple to review, allowing efficient 
editing and error-checking. 
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and providing a choice of answers to the first question for the user and advice from the system's 
knowledge base for deciding which of the answers to the first question to select. The choice of 
answer, however, remains under the control of the user, who can exercise professional judgment 
based on prior knowledge and advice provided by the decision management system. 

The method proceeds with asking the user following questions such as a second question 
from the question set. The second question is determined in part by the user's answer to the first 
question. For example, the second question may need to make reference to a fact the user has 
supplied in answer to the first question. Or the question selected by the system may change 
depending on the user's first answer. Whatever the effect of the first answer, the user is then 
provided a choice of answers to the second question, with one or more of the answers determined 
in part by the user's answer to the first question. The user is also provided advice for assistance in 
choosing an answer to the second question, the advice also determined in part by the user's answer 
to the first question. 

The method then continues as described, with following questions, answers and advice 
influenced by the user's previous answers. Throughout the decision-making process, the user 
retains control of the answers if so desired, with the system providing advice from its knowledge 
base for assistance in answering a question. 

Although a decision management system according to the invention has many uses, it is 
particularly suited for document assembly. That is, the system allows an experienced lawyer or 
other professional to determine what provisions are suitable for a document such as a contract or 
license. This determination is based on the facts provided by the lawyer, judgments made by the 
lawyer while using the system, and the legal knowledge base of the system. Ultimately the lawyer 
chooses provisions based on professional judgment with the assistance of the system. A document 
can be assembled with the invention much faster and more efficiently than with traditional methods 
of researching the legal effects and cross effects of various provisions. 

This decision management system also includes a novel authoring program for preparing 
applications. Using an intuitive program block approach and index, an author can construct an 
application by placing questions, answer, choices, advice and provisions in program blocks each 
uniquely identified by name. The author then arranges and assembles these blocks to build an 
application program. The logic of the application is simple to review, allowing efficient editing and 
error-checking. Authors do not need prior computer training to use the authoring program. Hence, 
persons with the desired expertise in fields such as law, education and medicine can readily write 
applications for the decision management system. 

The foregoing and other objects, features, and advantages of the invention will become 
more apparent from the following detailed description of a preferred embodiment which proceeds 
with reference to the accompanying drawings. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a block diagram of the overall software architecture of a decision management 
system according to the invention. 

FIG. 2 is a screen display of a user interface used in an authoring program of the decision 
5 management system for writing application programs. 

FIG. 3 is a block diagram of the software architecture of an execution program of the 
decision management system for executing application programs. 

FIG. 4 is a block diagram of the software architecture of the authoring program of the 
decision management system. 

10 FI G. 5 is a flowchart illustrating the operation of a block editor within the authoring 

program. 

FIG. 6 is a flowchart of a change screen layout procedure within the block editor of FIG. 

5. 

FIG. 7 is a flowchart of an insert/edit component procedure within the block editor of 

15 FIG. 5. 

FIG. 8 is a flowchart of a main loop of the execution program that continually executes 
during operation of the execution program. 

FIG. 9 is a flowchart of a question sequence loop that operates within the main loop of 

FIG. 8. 

20 FIG - 10 is a flowchart of a question sequencer procedure that operates within the question 

sequence loop of FIG. 9. 

FIG. 1 1 is a flowchart of a process block procedure in the execution program for 
processing program blocks from the application program. 

FIG. 12 is a flowchart of a resolve conditional procedure that operates within the process 
25 block procedure of FIG. 1 1 . 

FIG. 13 is a flowchart of a process block element procedure that operates within the 
process block procedure of FIG. 1 1 . 

FIG. 14 is a flowchart of a get answer procedure in the execution program for getting 
answers from user input and passing the answers on to other procedures within the program. 
30 FIG - 15 is a flowchart of a show advice procedure that operates within the get answer 

procedure of FIG. 14. 

FIG. 16 is a flowchart of an answer reference procedure in the execution program for 
checking for previous references to an answer. 

FIG. 17 is a flowchart of a store accumulated result procedure in the execution program. 
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DETAILED DESCRIPTION 

A. Overview of the Decision Management System 
A computer-assisted decision management system according to the invention includes 
three major components. Referring to FIG. 1, one component of the system is an authoring 
5 program 22 that an author 24 uses for preparing a second component, an application program 26. 
These application programs can cover any number of subjects, such as education of students, 
training of workers, the assembly of a legal document or the rendering of a medical diagnosis. For 
assisting in understanding the invention, reference may be made to a document assembly program 
as a preferred embodiment, although it will be understood by those skilled in the art that the 
10 invention may be used in any number of fields such as mentioned above. A third component of the 
decision management system is an execution program 28 that executes or runs the application 30 
for interaction with a user 32. 

I. The Authoring Program and Application 
Programs 

15 FIG. 2 is a preferred embodiment of the visual interface 34 provided by the authoring 

program 22. Although any number of interfaces are possible, the interface 34 is preferred because 
it has proven to be simple for non-computer experts to learn and use to prepare application 
programs 26. Shown within the interface are several windows that display various data. Window 36 
and window 38 comprise workspaces in which blocks of the application 26 under development may 

20 be displayed and edited. The authoring program 22, as will be explained in detail below, places 
data including text, block references and conditional statements into application program blocks 
such as a question block displayed in window 36 and a help block containing advice explaining the 
question in window 38. The names of the blocks open in windows 36 and 38 are highlighted in bars 
37 and 39, respectively. Similarly, other types of program blocks can be created such as answer 

25 blocks that contain possible answers to questions and context blocks that explain the import of each 
answer. The workspace environment is quite versatile and allows multiple windows to be open 
simultaneously. 

The program blocks created for a particular application are accessible through du muex 
shown in windows 40 and 42. The index lists the names of the program blocks on the display for 

30 selection by the user, for adding new program blocks, for opening a block for editing in the 

workspace or for entry of a reference to an indexed block into an open block. The blocks in an 
index are organized into block groups (shown in window 40) and blocks within a currently selected 
group (shown in window 42). The name of the currently selected block group is highlighted in bar 
i4, and the name of the currently selected block is highlighted in bar 46. 

35 For example, the question block in FIG. 2 contains a reference to a program block EE 

Reference shown in the index. Whatever name is currently in the EE Reference block will be 
shown in the question when it is asked. The user will supply the EE name for the block in response 
to an earlier question from the application program prompting for the name. 
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The author thus writes an application program by creating appropriate program blocks, 
naming them and then selecting and assembling such blocks from the index in a desired order. Such 
selection includes selecting a conditional statement (such as an If-Then-Else statement) for insertion 
into a program block. The conditional statement is constructed to accept a reference to another 
5 block as a condition for evaluation. 

A detailed software description of the authoring program 22 is provided in section B, 

below. However, it will be understood by those skilled in the art that the application programs 26 

generated by authoring program 22 or its method, as claimed, are not restricted to use solely with 

the execution program 28. Nor is the execution program 28 or its method, as claimed, restricted to 

10 use with the applications generated solely by the authoring program 22. 

2. The Execution Program and Application 
Programs 

FIG. 3 is a block diagram of the software architecture of the other portion of the decision 
management system, the execution program 28. The program 28 runs on a host computer platform 

15 such as a microcomputer and is stored in a file system 48 within the computer. Through a 

question-and-answer dialogue managed by the program 28, a user 50 controls the overall operation 
of the execution program 28 and execution of the application program 26. 

The execution program comprises two main components: a sequence and control module 
52 and a virtual processor module 54. The control module 52 manages the dialogue with the user 

20 50 through various functions. These functions include managing the display of application output 
and the sequence in which application questions are asked of the user 50. These functions further 
include managing the storage and retrieval of files to and from the file system 48, and the 
scheduling of the application program's executable components on the virtual processor module 54. 
The virtual processor module 54 then executes the executable components of the 

25 application program 26, dynamic data employed in the execution and accumulates the output of the 
execution for interaction with the user. 

The application program 26 within the host platform is illustrated in FIG. 3 as a series of 
functional components. The components include a sequence list component 55, a questions & 
blocks component 56, an answers component 57 and an output component 58. Components 55 and 

30 56 are executable code in the application program 26. Answer component 57 and output component 
58 store data generated as a result of such execution. Components 55 and 56 are static data 
structures which are loaded from the application program 26 when the application is executed. The 
execution program 28 then creates dynamic data structures required for the application's execution, 
including answers component 57 for storing data entered by user 50 and output component 58 for 

35 storing output data. 

The execution program 28 thus is a computer-based method for assisting a user in making 
decisions in the process of completing a task defined by the application program 26. In summary, in 
the process of executing the application program 26, the execution program 28 provides a set of 



WO 99/18500 



-7- 



PCT/US98/21086 



questions for completing the task at hand. The user is asked a first question from the set as the 
execution program 28 provides a choice of answers to the first question for the user. The execution 
program also provides advice to the user for deciding which of the answers to the first question to 
select. This advice may take the form of help or context program blocks that can be accessed by 
5 user commands for explaining the meaning or consequence of a question or answer. 

The user's answer to the first question is recorded and a following, second question is asked from 
the question set. The content of the second question is determined at least in part by the user's 
answer to the first question. The execution program 28 responds by providing a choice of answers 
to the second question, one or more of the answers determined at least in part by the user's answer 

10 to the first question. The execution program 28 also provides advice to the user for deciding which 
of the answers to the second question to select, the advice determined at least in part by the user's 
answer to the first question. The second answer is also recorded. The above process is then 
repeated with other questions in the question set until all questions material to completing the task 
are asked and answered. A detailed description of the operation of ihe execution program is 

15 provided in part C of the patent. 

To accelerate operation of the execution program, it is often desirable to ask the questions 
in the question set in a predetermined order. This ensures (hat a question is not asked until all 
conditions precedent to that question are met. For example, in FIG. 2, the question requires the 
name of the employee. Thus a question asking the employee's name would first be asked in 

20 executing the application so that the name is available to this question when it is asked. 

In the preferred embodiment, the questions are asked and the answers and advice are 
provided by displaying them on a computer display. However, they may also be asked in any, 
number of ways, such as with audio or printing devices. 

The application program may also be set so that questions are asked in the execution 

25 program only if conditions precedent to the asking of the question have been met. If such conditions 
have not been met, then the question is not asked unless invoked by the user directly or required by 
follow -on logic. 

In the preferred embodiment, the act of determining the second question from the user's 
answer to the first question comprises incorporating information from the answer into the second 
30 question. 

Only material questions in the question set need to be asked. Whether a question is 
material is determined from one or more answers already given by the user to previously-asked 
questions. In some cases, these answers make the asking of the following question unnecessary or 
irrelevant. 

35 1116 execution program can provide a suggested response if the user fails to answer a 

question. The suggested response may then be adopted by the user as the answer. Alternatively, the 
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execution program may require a user-provided answer to a question before proceeding with further 
questions. 

In the context of a document assembly system, the questions in the question set seek facts 
or determine provisions for inclusion into a document. The method proceeds as described above, 
with the answers representing facts or provisions for inclusion into the document, such as shown in 
FIG. 2. The advice in such a system takes the form of explaining the significance of including an 
answer representing a provision into the document. 

B - Detailed Description of the Authoring Program and Application Programs 

FIG. 4 is a diagram of the software architecture of the authoring program 22. The 
authoring program 22 provides several environments in which the author can work to accomplish 
different tasks involved in the creation of a application program. From the opening screen of the 
interface 34 on a display the author uses menu choices to select a sub-environment 60 in which to 
work. The user can easily switch from any given environment to any other. 

A block editor 62 is provided for manipulating program blocks and their contents. With 
the block editor, the user 50 creates blocks 66 for holding data in the form of text, references to 
other blocks and conditional statements. The blocks that can be created include question blocks for 
asking questions and answer blocks for accepting answers to questions. As explained previously, 
blocks are the computational units or programs out of which all application programs 26 are built. 
Blocks are organized into groups, and indexes 64 are maintained which list (1) all groups, and (2) 
for each group, all blocks 66 within that group as illustrated in FIG. 2. 

For inserting a reference to an indexed block, a selection mechanism such as a cursor 63 is 
provided as an arrow in FIG. 2. Cursor 63 may also be used for inserting a conditional statement 
into the opened block or other editing as well. The conditional statement is constructed to accept a 
reference to an indexed block as a condition for evaluation. 

The block & package tester 68 permits an author to examine the behavior of all or part of 
a application program for a given set of inputs. Test results 70 is a display of the actual output 
produced by such an execution. 

The sequence list builder 72 maintains in the sequence list 74 an ideal order in which the 
application questions should be asked of the user 50. 

The application file creator 76 translates the application program 26 into a simplified 
format appropriate for transfer to other computing platforms. 
The translation is stored in the application file 78. 

By selecting the exit authoring program 80 choice, the user may quit the program. 

As will be subsequently described, the block editor 62 of the authoring program is further 
constructed to create an answer block for holding an answer to a question each time the authoring 
program creates a question block for asking a question. 
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The authoring program further includes a Qset editor (described hereafter) for creating a 
help block for holding instructions for answering a question and a context block for giving the 
context of a question each time the program creates a question block for asking a question. 
Procedures described herein then allow an author to insert and edit instructions and advice to the 
user. The Qset editor also creates a question condition block in which conditions may be placed via 
an insert procedure. If the conditions are met a question in an associated question block will not be 
asked. 

With the sequence list builder 72, the authoring program can require that questions in 
question blocks be asked in a predetermined sequence. 



10 



Authoring Program Environment Pseudocode 

While <true> 
Case < menu choice > 
" < block editor > " 
15 block editor 

" < block & package tester > M 

block &l package tester 
M < sequence list builder > " 

sequence list builder 
20 " < application file creator > M 

application file creator 
" <exit>" 

<quit the authoring program > 

25 1. BLOCK CONTENT MANAGER 

The Block Content Manager comprises several sub-environments to manipulate blocks and 
their contents. These are accessed with menu choices. 

With the block editor the author may open any block in the application and manipulate its 

contents. 

30 Questions are maintained as groups of related blocks called "Qsets". The "Qset editor" is a 

superset of the block editor, allowing the author simultaneous edit access to several blocks of a 
given Qset. 

Forms are groups of Qsets presented to the user as a single display. The "form editor" 
provides the author with an environment to manipulate forms. 



35 



While <true> 
Case < menu choice > 
"< block editor > M 
40 block editor 

< Qset editor > " 

Qset editor 
" < form editor > " 
form editor 

45 



Block Content Manager Pseudocode 
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2. BLOCK EDITOR 

Referring to FIG. 5, the block editor 62 is the primary environment in which the author 
works to create application programs 26. An application program includes one or more blocks. The 
blocks contain all of the text passages and computational statements that comprise the application 
program. Blocks are created, manipulated and edited in the block editor 62. 

Blocks are organized into groups, and within the block editor, an index of all groups, and 
an index of all blocks within a selected group may be displayed. At any given time one of the 
blocks may be open for editing. 

This is called the "open block", and its contents arc displayed in a scrolling workspace where they 
may be manipulated. A different block may be selected in the index, called the "current index 
block". Its group is the "current index group'). Most operations within the block editor that pertain 
to blocks manipulate the open block and the current index block. 

The block editor provides function selection through menu choices or other on-screen 
controls to manipulate blocks, manipulate block contents, manipulate the indexes, arrange the 
15 layout of the screen, and to select a different environment or quit the authoring program. 

The "group & block manger" functions 82 handle creation, deletion and renaming of 
blocks and groups. The "change screen layout" functions 84 allocate screen space among the block 
editor's various displays. The "set current group & block" functions 8 6 select the current index 
block and the current index group. The "open current block" function 88 opens the current index 
20 block. The "insert/edit component" functions 90 perform the actual editing of the open block's 
contents. The "authoring environments" functions 92 are the same choices available in all 
environments to move to a different environment or exit the authoring program. 



Block Editor Pseudocode 

25 While <true> 

Case < menu choice > 

" < group & block manager > " 

group & block manager 
"< change screen layout" 
30 change screen layout 

" < set current group & block in index > * 
s et current group & block 
" <open current block from index > M 
open current block 
35 H < insert/edit component of open block > " 
insert/edit component 
" < other authoring environments > " 
authoring environments 



40 3. OSET EDITOR 

Questions are implemented as a "question set" called a "Qset". a Qset is a set of blocks 
and other data structures which maintain the components related to any given question. The "Qset 
editor" permits the author to manipulate several Qset components simultaneously. 
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The Qset editor is accessed with a menu choice which relies on the current index block 
being a member of the Qset to be edited. Within the Qset editor, the author may select between one 
and four of the Qset's seven members for simultaneous display. The Qset members are the six Qset 
blocks: "question", "help", "context", "question condition" , "suggested answer" and "answer 
5 choice list", as well as the "answer format" data structure. 

If "answer format" is one of the members selected for display, the displayed dialogue will 
permit the author to set the type of the answer, to one of "text", "single choice" , "multiple choice", 
"acknowledge", "number", "date", "currency". The answer format dialogue also lets the author set 
whether any of the three "abstract answers" are permitted for this Qset. The abstract answers are 

10 not actual values, but rather properties of an answer. If permitted by the author they may be chosen 
by the user in lieu of providing an actual value in answering a question. The three abstract answers 
are: "N/A" which generally lets the user express that there will never be an answer to this question; 
"Blank" which lets the user request that a section of blank space be substituted for an actual answer 
(for answers that will be inserted in output produced by the application, this allows the answers to 

15 be filled in while editing the final document); and "OK", which has no fixed meaning (the 

application will typically interpret this answer based on instructions to the user contained in the text 
of the question). If the author enables the "Blank" answer, then the author may pick one of several 
character strings to be used as the blank section if the user picks the "Blank" answer. 

20 Qset Editor Pseudocode 

if < current index block is not Qset member > 
return 

< close index > 

< enable Qset member selection dialogue > 
25 while <true> 

if <user requests change in Qset member display > 

< adapt screen layout to request > 

if <user placed cursor in Qset member block > 
insert/edit component 
30 if < user places cursor in answer format dialogue > 

< enable user editing of answer format fields > 



4. GROUP & BLOCK MANAGER 

Through menu choices within the block editor, the group & block manager 82 gives the 
author access to six functions for creating, renaming and deleting groups and blocks. These 
functions are discussed in the following sections and include creating a block group, renaming a 
group, deleting a group, creating a block, renaming a block and deleting a block. 

Group & Block Manager Pseudocode 

While <true> 

Case < menu choice > 

" < create group > " 
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create group 
" < rename group > " 

rename group 
" < delete group > " 
5 delete group 

H < create block > " 

create block 
"< rename block > " 

rename block 
10 "< delete block >" 

delete block 



5. CREATE GROUP 

A Create Group procedure presents the author with an edit box to capture the name of the 
15 new group. The name is checked for validity, and the new group is created. 

Create Group Pseudocode 

< solicit new group name dialogue > 
if <name is valid > 
20 < create the group > 

Else 

< display error message > 
Return 

25 6. RENAME GROUP 

The Rename Group presents the author with an edit box to capture a new name for an existing 
group. If the current index group is not a "system 1 ' group (whose name 

may not be changed), the name is checked for validity, and the new name is assigned to the group. 

30 Rename Group Pseudocode 

If < selected group is a system group > 

< display error message > 

Return 

, < solicit new group name dialogue > 
35 if <name is valid > 

< rename the group > 

Else 

< display error message > 

Return 



40 



7. DELETE GROUP 



The Delete Group procedure allows a user to delete a group from the application program. 
If the current index group is a non-deletable "system group M , the authoring program displays an 
error message and terminates the operation. Otherwise, this procedure presents the author with a 
45 dialogue confirming the deletion. On confirmation, the current index group and all the blocks that 
belong to it are deleted. 
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Delete Group Pseudocode 

If < group is a 'system group" > 

< error message > 

5 Return 

If < confirm delete > 

< delete group's blocks > 

< delete current index group > 
Return 

10 " ~~ 

8. CREATE BLOCK 

The Create Block procedure presents the author with an edit box to capture the name of 
the new block. The name is checked for validity, and the new block is created within the current 
index group. If this is a Qset group, the other blocks of the Qset are automatically created. 
15 

Create Block Pseudocode 
If < current index group is restricted > 

< display error message > 

Return 

20 < solicit new block name dialogue > 

if <name is invalid > 

< display error message > 

Return 

< create the block > 

25 If < current index group is Qset group > 

< create other blocks of Qset> 

Return 



9. RENAME BLOCK 

30 Th e Rename Block procedure presents the author with an edit box to capture a new name 

for the current index block. The name is checked for validity, and the new name assigned to the 
block. If the block was a member of a Qset, the other members names are correspondingly 
changed. All references within the application may be changed to conform to the new block name. 

35 Rename Block Pseudocode 

If < current index group or current index block is restricted > 

< display error message > 

Return 

< solicit new block name dialogue > 
40 if < name is invalid > 

< display error message > 

Return 

< rename the block > 

If < current index group is Qset group > 
45 < rename other blocks of Qset > 

Return 
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10. DELETE BLOCK 

The Delete Block procedure presents the author with a dialogue confirming the deletion. 
On confirmation, the current index block is deleted. If the block was a member of a Qset, the other 
members are also deleted. 



Delete Block Pseudocode 

If < confirm delete > 

< delete the current index block > 
If < current index group is Qset group > 

10 < delete other blocks of Qset > 
Return 

11. CHANGE SCREEN LAYOUT 

Referring back to FIG. 5, a second group of functions within the block editor 62 is the 
15 Change Screen Layout functions 84. These functions are made available to the author through a 
variety of menu choices and other on-screen controls shown in FIG. 6. The " show/hide index" 
functions 106 permit the user to display or erase from the screen the group index and the index of 
the current index group's blocks. The "change open block size" function 108 permits the user to 
shrink or expand the screen size of the open block display 109, and to allocate screen space among 
20 the block editor's windows in various proportions. The "Change Qset layout" procedure 110 
handles the special case of screen allocation among the members of a Qset. 

Change Screen Layout Pseudocode 
Case < menu or control choice > 
25 " < show/hide index > h 

< show/hide index > 
" < change open block size > " 

< change open block size > 
" < change Qset layout > " 

30 change Qset layout 

12. INSERT/EDIT COMPONENT 

Referring back to FIG. 5, this group of operations 90 is used by the author to accomplish 
the actual creation and editing of the contents of the blocks that comprise the application program. 
35 These operations are always available to be performed within the block editor's open block, if there 
is one. 

The operations 90 are shown specifically in FIG. 7. To "type changes and additions to 
text" 118, the author selects text or places the cursor in the open block and edits its contents using 
the common text editing facilities. The open block is a scrolling window, so the extent of the 
40 block's contents is not limited by the size of the screen window. 

The "block reference" procedure 120 places a reference code to the current index block at 
the cursor location in the open block. 
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The "conditional statement* procedure 122 conducts a dialogue with the author for either 
editing an existing conditional statement or for placing a new conditional statement in the open 
block at the cursor location. 

The "loop statement" procedure 124 conducts a dialogue with the author for either editing 
5 an existing loop statement or for placing a new loop statement in the open block at the cursor 
location. 

The "store statement" procedure 126 conducts a dialogue with the author for assigning a 
value to a given selected block in the index. 

The "block exit statement" procedure 128 conducts a dialogue with the author for placing a 
10 block exit statement in the open block at the cursor location. 



Insert/Edit Component Pseudocode 
Case < menu or control choice > 
" <type changes or additions to text> " 
15 < author: edit open block > 

" < block reference > " 

block reference 
" < conditional statement > " 
conditional statement 
20 " < loop statement > " 
loop statement 
" < store statement > 11 

store statement 
" < block exit statement > " 
25 block exit statement 



13. BLOCK REFERENCE 

The Block Reference procedure 118 in FIG. 7 is described in pseudocode below. To 
30 include a reference in the open block to another block, the author establishes the desired block as 

the current index block, sets the cursor at the appropriate location in the open block, and then picks 
the "Insert Block Reference" choice off the "Insert" menu within the block editor. The authoring 
program responds by inserting an encoded reference to the current index block at the cursor 
location of the open block. 
35 ' 

Block Reference Pseudocode set current index block 

< author: set cursor location in index block > 
<menu choice: insert block reference > 

< insert reference code > 

40 — 

14. SET CURRENT INDEX BLOCK 

The procedure for establishing a new current index block in the Block Reference 
procedure 118 is described in the pseudocode below. The author first 
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selects the correct group (if it's not already selected) from the group index. Second, the author 
selects the correct block from the block index (which always displays the blocks of the selected 
group). The indexes are scrolling alphabetic lists of group names and block names. Selection is 
accomplished by clicking the mouse on the desired name. The selected name is displayed in the title 
5 bar of the index window. 

Set Current Index Block Pseudocode 
If < author: the current index group is not correct > 

< author: select another group > 

10 If < author: the current index block is not correct > 

< author: select another block > 

< display new current index group & block > 



15 



20 



15. INDEX VIEWER 

Activating an "index viewer" on-screen control displays the contents of the current index 
block in a window. The display may not be edited. This feature enables the author to rapidly view 
one block while editing another. The index viewer control may optionally be "locked on", which 
causes the new current index block to be displayed each time it is changed. This permits the author 
to glance at a sequence blocks with a minimum of manipulation. 



Index Viewer Pseudocode 

set current index block 

if <user selects index view control > 

< display current index block in window > 
25 if <user clicks mouse in window > 

< close window > 



16. INSERT/EDIT CONDITIONAL 

Referring to FIG. 7, the Insert/Edit Component procedure 90 includes a conditional 
30 statement procedure 122. To insert a new conditional statement with this procedure in the open 

block, the author starts by placing the cursor 63 at the desired insertion point. To edit an existing 

conditional statement, the cursor is placed anywhere within the first line of the existing conditional 

statement. The second step is for the author to choose either "if-then" or "if-then-else" from the 

"insert" menu. Unless a conditional statement template is already open, 
35 the "open conditional statement template" 130 procedure is called. A conditional statement may not 

nest another conditional statement within itself, but may contain a reference to another block that 

does contain an additional conditional statement. 

Conditional Statement Pseudocode 
40 If < author: new conditional statement > 

< author: place cursor at insertion point > 

Else 

< author: place cursor in first line of existing conditional statement > 
If < author: "if-then-else" type> 
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< menu choice: "if- then-else" > 

Else 

< menu choice: "if-then" > 

If <no conditional statement template already open> 
5 conditional statement template 

17, CONDITIONAL STATEMENT TEMPLATE 

The Conditional Statement Template procedure referred to in the pseudocode above is 
described in detail in the pseudocode below. In preparation to opening the conditional statement 

10 template, the authoring program first invites the author to name a new, or rename an existing, 

conditional statement. The authoring program also gives the author the opportunity to change the 
form of the conditional statement between "if-then" and "if-then-else". Next the template is opened 
and displayed to the author, and then an "edit conditional statement" procedure is called. Controls 
are provided to close the template and to save the conditional statement defined by the contents of 

15 the template. 

Conditional Statement Template Pseudocode 

< solicit conditional statement name> 

< solicit change of conditional statement form 
20 < open template > 

edit conditional statement 
If < author: save conditional statement > 

< assemble & insert conditional statement in open block > 

< close template > 

25 — " — 

18. EDIT CONDITIONAL STATEMENT 

To edit the content of a conditional statement, the authoring program displays a template 
that lays out each of the conditional statement's three components (conditional expression. "THEN" 
part, "ELSE" part) in its own editable scrolling window. The author may move freely among the 
30 three components either with the tab key or by setting the cursor in any of the three template 
windows. 

The details of editing the conditional expression are handled in a "construct conditional 
expression" procedure. 

Editing the "then" part as with any block contents is accomplished with the "insert/edit 
35 component procedure 90, with the exception that another conditional 
statement may not be inserted into the contents of the "then" part. 

If the conditional statement is of the "if-then-else" form, the author may edit its "else" 
part, following the same rules as with the "then" part. 

40 Edit Conditional Statement Pseudocode 

while <true> 

If < author: edit conditional expression > 
construct conditional expression 
If < author: edit "then" part> 
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insert/edit component 
If <"if-then-else" form> 
If < author: edit "else" part> 

insert/edit component 

5 " 
19. CONDITIONAL EXPRESSION 

A conditional expression is the component of a conditional statement that performs a 
logical operation that reduces either to "true" or "false". The most common such operation is a 
comparison, and for application programs, the most common of these is a comparison between the 
10 actual answer given by the user, and one of the possible answers provided by the author. 

The application program provides a special "answer test expression" constructor to handle 
this case. Other conditional expressions are constructed like any other block contents, using the 
"insert/edit component" procedure. 

To construct an answer test expression, the author first makes the answer block (in which. 
15 at run time, the actual answer will be found) the current index block, and then chooses menu item 
"answer test" from the "insert" menu. 

The authoring program will display a list of the possible answers which the author has 
provided for the given question, and the author picks the one to compare with the actual answer. 

Next, the authoring program solicits from the user the type of comparison that should be 
20 applied between the possible and actual answers. 

After this, the authoring program asks the author whether the reference to the actual 
answer in the comparison should be "active" or "passive". These behave the same if an answer 
exists at the time of the reference. But if there is no answer, an active reference will cause the 
question to be asked at the time of the reference, while a passive reference simply returns an 
25 indication that the answer is empty. 

Finally, the authoring program assembles the answer test conditional expression and inserts 
it in the expression box of the template. 



Conditional Expression Pseudocode 
30 If < author: wishes to construct custom expression > 
insert/edit component 

Return , 

If < author: wishes t-o construct answer test expression > 
< author: set answer block in index with ... > 
35 set current index block 

< menu choice: "answer test" > 

< display list of possible answers > 

< author: pick answer to compare > 

< display comparison types > 

40 < author: pick comparison to use > 

< ask author if answer reference is active or passive > 

< author: select active or passive reference > 

< assemble and insert answer test conditional expression 
in box > 
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Return 



20. STORE STATEMENT 
5 This procedure shown in FIG. 7 inserts a store statement at the cursor location. The Store 

statement permits the author to provide for the explicit replacement with an arbitrary value of the 
contents of FACT blocks. 

The block to be stored into must be the current index block. For the value to be stored, the 
author has three options. (1) Literal text which the author provides by typing or pasting. (2) A 
10 block reference which is captured through a special dialogue. (3) As an optimization of the general 
block reference, an answer reference is captured with a simpler dialogue. 

Store Statement Pseudocode 

case < menu selection > 
15 < "store fact" > 

if < index group is not "fact" > 
return 

< "store answer" > 

if < index group is not "answer" > 
20 return 

case < store value dialogue result > 

< "text" > 

< enter text in dialogue > 

< "block reference" > 
25 block identification dialogue 

< "answer reference" > 
answer identification dialogue 

< insert store statement at cursor > 



30 



21. BLOCK IDENTIFICATION DIALOGUE 

The Block Identification Dialogue procedure detailed in the following pseudocode is used 
by other procedures to solicit a needed block identity from the author when the index (typically 
used for this purpose) is already committed to identifying some other block. 
35 First > the dialogue presents the author with a list of all groups and solicits the author to 

pick one. Second, the dialogue presents the author with a list of all blocks within the selected group 
and solicits the author to pick the desired block. 

Block Identification Dialogue Pseudocode 

40 display group list 

< solicit group selection from the author > 
display selected group's block list 
< solicit block selection from the author > 



45 
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22. ANSWER IDENTIFICATION DIALOGUE 

The Answer Identification Dialogue noted in the above pseudocode is used by other 
application program procedures to solicit a needed answer identity from the author when the index 
(typically used for this purpose) is already committed to identifying some other block. 
5 The dialogue presents the author with a list of all answers and solicits the author to pick 

the desired one. 

Answer Identification Dialogue Pseudocode 

display answer list 
10 < solicit answer selection from the author > 

23. LOOP STATEMENT 

The loop statement in FIG. 7 permits the author to include a loop in the contents of a 
block. The author is presented with a template consisting of two parts to be completed. Completing 
15 the "conditional expression" is described in the "construct conditional expression" procedure. The 
body of the loop is constructed in accordance with the "insert/edit component" procedure. 

Loop Statement Pseudocode 

display loop template 
20 if <user places cursor in conditional expression box. construct conditional 

expression 
if <user places cursor in loop body box. 

insert/edit component 

25 24. APPLICATION TEST MANAGER 

The Application Test Manager is a collection of procedures in the authoring program 22 
used by the author to check the behavior of the application. The "block tester" will execute any 
given block, and all the blocks referenced from that origin. The "question tester" will present any 
of the application's questions along with all supporting fields. 



30 



case <mcnu choice > 
< "block tester" > 
block tester 
35 < "question tester" > 
question tester 



Application Test Manager Pseudocode 



25. BLOCK TESTER 

An interpretive version of the execution program 28 is built into the authoring program 22 
40 as a block tester. The block tester runs any block (identified by the current index block) producing 
a displayed result that may be edited and saved in a file. The behavior of the execution will be 
controlled by the answer set maintained by the authoring program. Any answers given during the 
execution will become part of the current answer set. 
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25 



30 



Block Tester Pseudocode 

set current index block 
run current index block 

< display execution results in edit window > 

< enable author to edit & file results > 



26. QUESTION TESTER 

The author uses this procedure in the authoring program to present any of the application's 
questions along with all supporting screens and fields, controlled by the state of the answer sei 
10 maintained by the authoring program. The question to ask is identified by an opening dialogue that 
has the author pick a Qset off a displayed list of all Qsets in the application. 

Question Tester Pseudocode 

display Qset list 
15 < solicit author to select Qset from list> 

display question run-time dialogue 

< solicit author to interact with dialogue > 



27. SEQUENCE LIST MANAGER 
20 This menu choice presents the author with a display of the sequence list structures, which 

consist of two lists of Qset names: the sequence list and the unlisted Qset list. The display includes 
the necessary controls to move names between the two lists, and to exit the sequence list manager. 
The author controls the order of the sequence list. The unlisted Qset list is always maintained in 
alphabetical order. 



Sequence List Manager Pseudocode 

display sequence list structures 

< author edits sequence list > 

< author exits sequence list manager > 

28. INPUT/OUTPUT MANAGER 

The input/output manager incorporates several input/output operations accessed through 
menu choices. 

35 Input/Qutput Manager Pseudocode 

case < menu choice > 

< "group lister" > 

group lister 

< "Qset lister" > 
40 Qset lister 

< "logic lister" > 

logic lister 

< "help & notes window" > 

help & notes window 
45 < "library builder M > 
library builder 

< "application exporter" > 

application exporter 
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< "clear application" > 

clear application 

< "import blocks" > 

import blocks 
5 < "symbolic section number manager" > 
symbolic section number manager 

< "search & replace" > 

search & replace 
<"text window" > 
10 text window 



29. GROUP LISTER 

This menu choice produces, in a window, a formatted display of the contents of all blocks 
15 in the current index group. The display may be edited and saved to a file. 



25 



30 



35 



40 



Group Lister Pseudocode 

set current index group 
< display formatted listing in edit window > 
20 < enable author to edit & file results > 



30. OSET LISTER 

This menu choice produces, in a window, a formatted display of the contents of all Qsets 
identified through a selection dialog. The display may be edited and saved to a file. 

Qset Lister Pseudocode 

select scope of Qsets to list 

< display formatted listing in edit window > 

< enable author to edit & file results > 

31. LOGIC LISTER 

This menu choice produces, in a window, a formatted display of the complete logical tree 
of processing permutations available from the origin of the current index block. The display may be 
edited and saved to a file. 

Logic Lister Pseudocode 

set current index block 

< display formatted logic listing in edit window > 

< enable author to edit & file results > 



32. HELP & NOTES WINDOW 

The help & notes file is part of the authoring program 22 provided to an author. The file 
initially contains information on a variety of subjects relevant to the authoring process. The author 
may modify or augment this file to accumulate the author's own notes during authoring. This menu 
45 choice opens the current help & notes file for editing. The author may edit and save the file. 
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Help & Notes Window Pseudocode 

< open help & notes file > 

< enable author to edit & file results > 

33. LIBRARY BUILDER 

5 This menu choice creates a library file from the current index group. A library file stores 

the contents of the group's blocks in a format that enables the end user to modify the contents. 

Library Builder Pseudocode 
set current index block 
10 < create library file > 

34. APPLICATION EXPORTER 

This menu choice creates an application export file for the application. This file contains 
the substance of the application in a format that permits the application to be transported to different 
15 computing platforms. 

Application Exporter Pseudocode 

< translate application to export format > 

< write application export file > 

20 



35. CLEAR APPLICATION 

This menu choice erases all application dependent data structures. The authoring program 
22 is returned to its initial empty state. 
25 _ 

Clear Application Pseudocode 

< clear all application dependent data structures > 

36. IMPORT BLOCKS 

30 ™ s menu choice manages the copying of blocks from one application into another. From 

within the local application the author identifies through a dialog the remote application. The 
authoring program either imports the entire remote application or displays the remote application's 
index, and the user selects the group or block to be moved. Further menu choices move the selected 
group or block. The author exits the import block operation by closing the remote index. 

35 

Import Blocks Pseudocode 

< display open dialog > 

< author opens remote application > 

< display remote application index > 
40 while < remote index open> 

set remote index block & group 

< import block or group > 



45 
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37. SYMBOLIC SECTION NUMBERS 

The symbolic section number facility of the authoring program manages a data base of 
symbols which may be arbitrarily inserted by the author into text within blocks. At run time these 
symbols will be converted into section numbers. Symbols are -declared" when they are placed at 
5 the location where the author expects them to be treated as actual numbers in a sequence of 

automatically assigned section numbers. Symbols are "referenced" when the author expects them to 
be replaced in the text by a section number declared elsewhere. Symbols may be referenced 
anywhere, but may be declared only in one location. 

This menu choice displays a compound list of symbols identifying which have been already 

10 declared and which have been placed on the list but not yet declared. On-screen controls enable the 
author to perform the following symbol operations: (1) Add or delete a symbol from the compound 
list; (2) Declare a symbol on the list to be a symbol for a section number to be generated (at run 
time) at the current cursor location in the open block; (3) Insert a reference (a symbol declared 
elsewhere) at the current cursor location in the open block. At run time the actual number will be 

15 substituted for the symbol; (4) Search all blocks for references to undeclared symbols; (5) Search 
all blocks for occurrences of a given symbol. 

Symbolic Section Numbers Pseudocode 

< display symbol lists > 
20 case <user selected symbol operation > 
" < add or delete symbol > * 

< add or delete symbol > 
" < declare symbol >" 

< declare symbol > 
25 " < insert reference > " 

< insert reference > 

" < search for an undeclared symbol > " 

< search for an undeclared symbol > 
" < search for a given symbol > " 

30 < search for a given symbol > 



38. SEARCH & REPLACE 

The authoring program 22 further provides the author with a comprehensive search and 
replace facility. The search & replace menu choice presents a dialog with which the author selects 
either a text string or a block reference as the subject for which to search. A second dialog solicits 
from the author a choice between the open block and all blocks as the scope of the search. A third 
dialog determines whether the operation should be a search or a replace. The search operation 
produces a search report which is displayed in a window, and may be edited and saved in a file. 
The replace operation solicits the author for the replacement text, and whether to employ the 
optional confirm step, and then performs the replacement. 
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Search & Replace Pseudocode 

< present target select dialog > 
if < target is string > 
then < author enters search string > 
5 if < target is block reference > 
then <use current index block > 

< present scope select dialog > 

< present search/replace dialog > 
if < operation is replace > 

10 then 

< solicit replacement text> 

< ask whether to confirm > 

< perform replacement > 

else 

15 < perform search > 

< display search report > 

< enable author to edit & file report > 



20 39. TEXT WINDOW 

This menu choice enables the author to open, view, and edit any file without leaving the 
authoring program. 



Text Window Pseudocode 

25 < present open dialog > 

< display file in window > 

< enable author to edit & save file> 



C. Detailed Description of the Execution Programmed Application Programs 
30 Major execution program procedures are described textually and by pseudocode below, in 

conjunction with a related flowchart. Individual procedures are identified by a numeral. Actions 
taken within a procedure are identified by a numeral in parentheses. 
1 . Main Loop 

As shown in FIG. 8 (Main Loop), the main execution loop of the execution system is 
35 structured as a case statement that handles requests by the user. Main Loop is responsible for 

loading an application file, producing results for a user from the execution of an application file, 
manipulating specific files and exiting the execution system. As indicated in FIG. 8 this list of tasks 
is not exhaustive. 

With reference to the first step in Main Loop, the execution system waits for user action if no 
40 user request is pending (280). Once a request is made, the main loop determines the nature of the 
request and branches to the appropriate procedure to carry out the request. These procedures, 
which include Question Sequence Loop 282, are described in the flowcharts that follow FIG. 8. 
Main Loop is also the procedure in which the user asks for results (283). 



45 
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Main Loop Pseudocode 

While <true> 

If <user request not pending > 
Then < wait for user request > 
5 Case USER REQUEST 

"<load application > " 
question sequence loop 
" < produce results > H 
produce results 
10 " < other requests > * 

< other operations. 
" < exit > " 

< quit the execution system > 



15 



2. Question Sequence Loop 

If the user requests the execution system to load an application program 26, Main Loop 
loads the application 26 and then branches to the Question Sequence Loop 282. Procedure 282 is 
shown in further detail in FIG. 9 and includes several other procedures and a decision point. 

20 Procedure 282 begins by calling a Question Sequencer 284 shown in FIG. 10 to determine if there 
is another question on the sequence list to be asked. If there is another question, the procedure 282 
calls Ask Question procedure 286 to ask the user the next question. If there is not another question, 
procedure 282 executes FirstBIock with the Process Block procedure, and then returns to Main 
Loop (FIG. 8). Procedure 282 also returns to Main Loop if the user makes a general request (a 

25 request outside the scope of asking and answering questions). 

Question Sequence Loop Pseudocode 

While <true> 

question sequencer 
30 If < there are no more questions > 
Then Return ask question 
If < general user request pending > 
Then Return 

35 3. Question Sequencer 

The Question Sequencer procedure 284 in FIG. 10 determines if there is another question 
yet to be asked of the user 260 in running application program 26. Running an application program 
in the execution program 28 occurs in two stages. First, all of the questions on the sequence list 
that should be asked are asked. This is the function of the Question Sequencer Loop 282. Second, 

40 FirstBIock, the entry point to the execution system, is executed. Calling FirstBIock might result in 
more questions being asked "on-the-fly, M as will be described. 

Procedure 284 determines the sequence of questions asked during the first stage, and 
determines when this stage is complete. It returns to the Question Sequence Loop 282 either the 
identification of the question to ask next (the current question,) or an indication that there are no 

45 more questions to ask in this stage. 
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Assuming the normal sequence mode, the procedure 284 starts by examining the current 
question on the sequence list (288). If it is unanswered and not suppressed by a Check Question 
Suppression procedure 89, or if it is answered, but the status of the answer is below the threshold 
currently set by the user, then the ID of the current question is returned to procedure 282 as the 

5 next one to be asked (290). If, on the other hand, the current question is unanswered but 
suppressed, or answered with a status at or above the current threshold, the procedure 282 
increments to the next question on the sequence list, and examines the new current question (292). 

When procedure 282 reaches the end of the sequence list, the execution system switches 
from "normal" to "tentative" sequence mode (294). It proceeds as before, except that only 

0 questions marked as tentative are asked (296). All such tentative questions will sequentially and 
repeatedly be promoted to the current question, and reasked, until the user cancels the tentative 
status of all questions. At this point, there are no more questions to be asked from the sequence list, 
and procedure 284 returns this indication to the Question Sequencer Loop procedure 282 (298). 



* 5 Question Sequencer Pseudocode 

While <tme> 

- Processing for tentative mode. 
If SEQUENCE MODE = " < tentative > * 
If < there are any tentative questions > Then 
20 Set CURRENT QUESTION To <next tentative question > 
Return 
Else 

Set CURRENT QUESTION To <no more questions > 
Return 

25 - Current question needs an answer and is not 
suppressed? ask it. 

If < there is no answer to the current question > 
and < the current question is not suppressed > 
Then Return 

30 -- Current question answered but status no good? -- ask 
it 

If < there is an answer to the current question > 
and < answer status too low > 
Then Return 
35 -- Otherwise try next question. 

< increment > CURRENT QUESTION 

If < end of sequence list > 

Then Set SEQUENCE MODE To < tentative > 

TopOfLoop 

40 



4. Check Question Suppression 

Any question on the sequence list may be guarded by a "question condition. " This is an 
optional program written by the author and contained in the question's data structure. Each question 
on the sequence list will be asked, in order, unless the question is suppressed by its own "question 
condition" program. 
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The Check Question Procedure 289 runs the current question's "question condition" 
program to determine whether the question should be asked or suppressed. The procedure begins by 
determining if a "question condition" block exists for the current question. If not, the procedure 
returns a "< don't suppress > " to Question Sequencer 284. 

If a "question condition" program does exist for the current question, procedure 284 passes 
the "question condition" ID as a parameter to a Process Block procedure (to be described) and then 
calls that procedure. If the result of calling Process Block is false (the question's conditions are not 
yet met), the procedure 289 returns "do suppress" to procedure 284. If the procedure 302 does not 
return false (the question's conditions have been met), procedure 289 returns "don't suppress." 



Check Question Suppression Pseudocode 
If < question condition does not exist > 
Then Return "< don't suppress > " 
process block (< question condition block ID > ) 
15 If < accumulated result > = "< false >" 
Then Return " < do suppress > " 
Else Return "< don't suppress > " 



5. Process Block 

20 A bIock > whether it is a "question condition" block or other block in the application 

program 26, is a data structure consisting of a list of elements. Each element is an instruction 
intended for execution on virtual processor module 54. All the elements together comprise the 
block's virtual program. The Process Block procedure is the component of virtual processor 
module 54 that determines which block element to execute next, and what information returns when 

25 the block's program has run to completion. 

The Process 'Block procedure is shown in FIG. 11. It first checks to see the block 
program it is processing is finished, i.e., it encounters an exit block element signaling the block's 
end (300). If not, it selects the next element of the block program and determines how it should be 
treated (3 04 ). If the element is a conditional statement, the Process Block procedure calls a 

30 Resolve Conditional procedure (306). If the element is not a conditional statement, the Process 
Block procedure calls a Process Block Element procedure (308). The results of these procedures 
are returned to Process Block procedure. The Process Block Element procedure is responsible for 
the actual execution of the elements. The result of element execution is the accumulation of results 
in a data structure called Accumulated Result. Accumulated Result is used by many procedures. 

35 including Get Question. 

Process Block Pseudocode 
If < next block element > = < exit block > 
Then return select next element 
40 If < next block element > = < conditional statement > 
Then 

resolve conditional 
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TopOfLoop 

process block element 



6. Resolve Conditional 

A conditional statement comprises three components: a conditional expression, a Then 
component, and an Else component. The Else component may be empty. The Then and Else 
components are each groups of block elements. After executing either of these groups, processing 
continues with the block element following the entire conditional statement. The Resolve 
Conditional procedure illustrated in FIG. 12, evaluates a conditional expression of a conditional 
statement within a block program for true or false. Based on this evaluation, the procedure 
identifies the first element of either the Then or the Else component of the conditional statement as 
the next element to be executed. 



Resolve Conditional Pseudocode 
15 If < evaluate conditional expression > 

Then Set <next block element > To < first element of <then> 

component > 

Else 

If < conditional statement includes <else> component > 
20 Then 

Set <next block element > 

To < first element of <else> component > 

Else 

Set < next block element > 
25 To < first element following conditional statement > 
Return 



7. Process Block Element 

As noted above, the Process Block Element procedure is responsible for executing the 
elements of a block program. The results of such an execution is accumulated into a data structure 
called Accumulated Result. For each element whose execution produces a result, that result is 
appended to the preexisting result within the Accumulated Result procedure shown in F jn * . P. This 
Accumulated, Result is emptied by a procedure Store Accumulated Result into the calling 
procedure, here the Process Block. FIG. 13 illustrates the operation of the Process Block Element 
procedure. 

The Process Block Element procedure is essentially a case statement with a case for each 
element type. 

A text element is a descriptor which identifies a fixed block of text. Its execution appends 
that text to the Accumulated Result. Answer reference elements are elements that involve a more 
detailed analysis, for which a procedure Answer Reference is called. Execution of a block 
reference element results in a recursive call on procedure Process Block. Any result produced by 
the recursive procedure is appended to the Accumulating Result. 
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Process Block Element Pseudocode 

Case < element type > 

< text > 11 

< accumulate text into result > 

< answer reference > 11 
answer reference ( < question ID > ) 

< block reference > 11 
process block ( < block id > ) 

Return 



8. Answer Reference 

This procedure is called by the Process Block Element procedure and asks if the current 
15 question has an answer stored and, if yes, if the existing answer has a status at or above a current 
threshold. If so, the procedure appends the answer to the Accumulated Result. If not, the procedure 
calls the Ask Question procedure. 



Answer Reference Pseudocode 

20 If < no current answer > 

or < answer below current threshold > 
Then ask question 

< append answer to accumulated result > 



25 9. Ask Question 

This procedure is called by the Question Sequence Loop 282 of FIG. 9. and by the Answer 
Reference procedure. It asks the identified question of the user and captures the user's answers. 
The Ask Question Procedure comprises calls to three other procedures: Generate Question, Present 
Question, and User Answer. 



Ask Question Pseudocode 

generate question 
present question 
user answer 
35 Return 



10. Generate Question 

The Generate Question procedure produces text strings that, when displayed to the user, 
constitute asking the question. Three of these strings are produced by calling three procedures in 
40 Generate Question. Get Question constructs the text of the question itself. Get Prompt handles the 
construction of the list for multiple choice type questions. Retrieve Current Answer secures the text 
of a previous answer, or where appropriate, a suggested answer. The result of executing the 
Generate Question procedure is a data structure made up of these three text strings returned to the 
Ask Question procedure. 



Generate Question Pseudocode 
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get question 
get prompt 

retrieve current answer 



5 11. Get Question 

This procedure produces the text of a question. A question's text is represented as a 
program contained in a data structure called the Question Block. For a given question, this block is 
identified by a number. In the Get Question procedure, the question block's identifying number is 
passed as a parameter to Process Block which runs the program in Question Block. The result of 
10 executing the Process Block procedure is the production of text. When Process Block returns, this 
text is stored into the question string, by calling Store Accumulated Result with the question string 
passed as a parameter to Accumulated Result. 

Get Question Pseudocode 
1 5 process block( < question block ID > ) 

store accumulated result( < question string ID>) 

The accumulated result in the Get Question procedure is returned to the Generate Question 
procedure. At this point the text of the question as generated by any preexisting result is at hand. 
20 The Generate Question procedure then calls the Get Prompt procedure. 
12. Get Prompt 

This procedure produces the text of a question's prompt. For multiple choice type 
questions, the prompt specifies the list of choices presented to the user. A prompt's text is 
represented as a program contained in a data structure called the Prompt Block. For a given 
25 prompt, this block is identified by a number. The prompt block's identifying number is passed as a 
parameter to Process Block which runs the program. The result of this execution is the production 
of text which is also stored in the data structure Accumulated Result. When the Process Block 
procedure returns, this accumulated result is stored into the prompt string, by calling Store 
Accumulated Result with the prompt string passed as a parameter. 



Get Prompt Pseudocode 

process block ( < prompt block ID > ) 

store accumulated result(< prompt string ID>) 

Return 



The last procedure called in the Generate Question procedure is the Retrieve Current 
Answer procedure. 
13. Retrieve Current Answer 

This procedure is responsible for reporting back with a given question's current answer, if 
40 it has one, and if there is no answer, reporting back that the answer is empty. This is distinguished 
from the Answer Reference procedure which will spontaneously ask the question if it finds the 
answer empty. 
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Note that the abstract answer "declined" is a bona fide answer, distinct from the empty 

answer. 

If an answer exists it is placed in the question's answer string, and the procedure returns. 

If this call arose through a call on Ask Question, the motive is to display the most helpful 
5 representation of the current answer to the user to help the user in selecting the user's own answer. 
To this end, if there is no answer, but a suggested answer program has been provided by the author 
for this question, then the suggested program is run through a call to Process Block and the 
Accumulated Result. The text of the suggested answer is then placed into the answer string and 
subsequently displayed to support the user in answering the question. 
10 If this call arose from a Retrieve Current Answer in a block program, this indicates that 

the application is trying to determine if the user has answered the question. Substituting the 
suggested for an empty answer in this case would be misleading, and the answer string is set to 
empty. 

15 Retrieve Current Answer Pseudocode 

If < a real answer exists > 

< store the answer in the answer string > 

Return 

If <call arose in a block program > 
20 < store < empty > into the answer string > 

Return 

process block ( < default block ID > ) 

store accumulated result (< answer string ID > ) 

Return 

25 " 

The result of calling these three procedures and the procedures they call is to generate and 
return to the Ask Question procedure the data structures necessary to present a question to the user. 

The Ask Question procedure then calls the Present Question procedure. 
14. Present Question 

30 Thi s procedure is responsible for presenting questions to the user in one of two forms, 

depending on the display mode. In the spreadsheet mode, the questions are presented in a compact 
format that compresses each question and current answer into a single line of a scrolling 
presentation. The current question is identified in the presentation. In the question mode, the 
current question, prompt and answer choices are displayed in full on the screen. The Present 

35 Question procedure then returns to the Ask Question procedure. 



Present Question Pseudocode 
40 If DISPLAY MODE = < spreadsheet > 
Then 

< display spreadsheet > 

< identify current question on spreadsheet > 

Else 
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< display question > 

< display prompt if appropriate > 

< display existing or suggested answer if appropriate > 

Return 



The Ask Question procedure then calls the User Answer procedure. 
15. User Answer 

This procedure analyzes and stores an answer or certainty change provided by the user in 
response to the presented question. A certainty change is recorded in the certainty level field of the 
10 question data structure. An answer is recorded in the answer string field of the question data 
structure . 

Any of the three abstract answer types (declined, blank, OK) are recorded in the answer 
string field of the question data structure. The Ask Question procedure then returns the answer to 
the Answer Reference procedure, which appends it to the data structure Accumulated Result. 



User Answer Pseudocode 

Case < answer rype > 
" < certainty change > " 

< record new certainty level > 
20 " < ordinary answer > M 

< record new answer > 
" < declined > H 

<mark answer < declined > > 
"< blank >" 
25 < mark answer < blank > > 

"<OK>* 

<mark answer <OK> > 

Return 



16. Get Answer 



This procedure, illustrated in FIG. 14, processes user activity while awaiting a user 
answer to a presented question. The structure is a case statement within an endless loop. 

The Get Answer procedure will process repeated user requests related to securing an 
35 answer until an answer is finally given via User Answer procedure. At this point the Get Answer 
procedure calls the User Answer procedure to analyze and store the answer. 

If the user requests a service unrelated to providing an answer (a general user request) the 
procedure returns back to the execution system's main loop where these requests are handled. 

Request for display of advice, "help" and "context," are handled by a Show Advice 
40 procedure 338 to be described. On return, Get Answer continues. 

If the user changes the display mode between the full question presentation and the 
spreadsheet, the Present Question procedure is called to present the correct display, after which Get 
Answer continues. 
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If the user requests a marking operation, this is accomplished by a Marking Operations 
procedure 340. Upon return, Get Answer continues. 

Changes to an answer's certainty are handled (as with changes to the answer) by the 
procedure User Answer 322. But after returning from a certainty change Get Answer continues, 
5 rather than returning. 

Any other user action is ignored, and Get Answer continues. 



GET ANSWER PSEUDOCODE 

While <true> 
10 Case < user action > 
" < answer > " 
user answer 
Return 

" < general user request > " 

1 5 Return 

" < advice request > H 
show advice 
TopOfLoop 

" < change display mode > " 
20 present question 
TopOfLoop 

M < marking request > " 
marking operations TopOfLoop 

" < change certainty request > " 
25 user answer 
TopOfLoop 
< any other value > 
TopOfLoop 

30 ~~ 

17. Show Advice 

This procedure, shown in FIG. 15, is called when the user requests advice to assist in the 
answering of a question. First the procedure determines whether the user requested "help" advice 
or "context" advice, and then calls Process Block 302, passing as a parameter the appropriate (help 
35 or context) block identifier belonging to the current question (342, 344). On return from Process 
Block, the accumulated result is displayed for the user (346), and Show Advice 338 returns to its 
caller. 



Show Advice Pseudocode 
40 If < advice type requested > = <help> 
Then process block ( < help block ID > ) 
Else process block (< context block ID>) 
< display accumulated result > 
Return 

45 ' 

20. Marking Operations 
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This procedure allows the user to select a group of questions and perform one of several 
operations on the selected group. Depending on the category of the marking operation, the 
procedure allows a user to identify a group to be marked or to manipulate a marked group in the 
manner listed. 

5 

MARKING OPERATIONS PSEUDOCODE 
If < marked group identification operation > 
Case < operation type > 

" < (un)mark current question > " < . . . > 

10 "<(un)markall>" <...> 

" < invert marks > M < . .. > 

" < show/hide marks > " < . . . > 

" < mark unanswered > " < . . . > 

" < mark old answers > " < . . . > 

15 " < mark new answers > " < > 

" < mark double checked > " < . . > 

" < mark tentative > " < . . . > 

" < mark untentative > " < . . . > 

" < mark declined > " < . . . > 

20 "< mark blank >" < > 

" <markOK>" <...> 

Else must be < marked group manipulation operation > 

Case < operation type > 

" < load answers/notes file > * < . . . > 

25 " < save answers/notes file > " < . . . > 

" < clear answers/notes > H < . . . > 

" < asked only marked questions > " < . . . > 

Return 



30 



D. The Integrated System 
As described above, the major components of the computer-assisted decision management 
system are the authoring program 2i, the applications 26 and the execution program 28. A unique 
feature of this invention is the division of programming labor among the components. 

35 The execution program 28 is best described as a virtual processor, engineered on the 

model of a computer but implemented in software. The blocks and other data structures produced 
by an author are in effect the source code, compiled with the authoring program 22 into 
applications 26 which then run on the execution program 28. 

The system divides the programming labor so that the author has maximum freedom in 

40 incorporating knowledge into the applications. But the author is not concerned with programming 
many ordinary aspects of a computer implementation usually required to be specified by an 
application author. The execution program 28, as a virtual processor, implements every aspect of 
an application that is not essential to the author's role as knowledge contribution. The result is that 
applications 26 are concise structures not complete applications in any conventional sense. An 

45 application has content, but a substantial portion of the application's behavior-the way it is 
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displayed and reacts to user input-is contributed directly by the virtual processor and need not be 
programmed by the author. 

Specifically, the application 26 contributes all the questions which may be asked during its 
execution and the rules which control what questions are asked, in what form, and in what order. 
The program logic of the application also determines text displayed to the user as questions, 
prompts, choice lists, tags, application advice and application context. The program logic further 
determines results provided. 

The virtual processor contributes all screen, keyboard, mouse, file management actions 
and all controls necessary for the user to manage every aspect of the application's execution. The 
processor creates the different display environments including a central control panel, a question 
display, a spreadsheet display, a results display, etc. All string management is handled by the 
virtual processor as well as a full complement of file operations for reading and writing application, 
answer, notes, marks and results files. This includes the ability to select any file, directory or disk 
by picking choices from lists. 

Finally, the virtual processor controls the execution of the application, which follows rules 
and logic specified in the application to govern the order and form of question presentation and the 
formulation of text for screen presentation and results. 

Having described and illustrated the principles of the invention with reference to preferred 
embodiments and several variations thereon, it is apparent that such embodiments can be modified 
without departing from such principles. For example, many of the procedures herein may be 
rewritten and yet be equivalent in operation and function. 

In view of these and the wide variety of other embodiments to which the principles of the 
invention can be applied, the illustrated embodiments should be considered exemplary only and not 
as limiting the scope of the invention. We therefore claim as the invention all such modifications as 
may come within the scope of the following claims and equivalents thereto. 



WO 99/18500 



-37- 



PCT/US98/21086 



We claim: 

1 . A computer-implemented method of assisting a user in completing a task, the 
method comprising the following steps: 

dynamically generating a question for presentation to the user by executing a question 
5 procedure that includes a reference to another procedure, the referenced procedure generating 
content for the question based on an analysis of one or more previous answers given by the user; 

recording an answer given by the user to the presented question for use in generating 
content for another question; and 

repeating the steps of generating questions and recording answers to complete the task, 
10 taking into account answers given by the user in generating additional questions. 

2. A computer readable medium on which is stored computer instructions for 
performing the steps of claim 1 . 

3. A computer-implemented method of assisting a user in completing a task, the 
method comprising the following steps: 

15 generating a question for presentation to the user by making a reference to a procedure for 

generating question content that is literally different from but based on an analysis of one or more 

previous answers given by the user; 

recording an answer given by the user to the presented question for use in generating 

content for another question; and 
20 repeating the steps of generating questions and recording answers to complete the task, 

taking into account answers given by the user in generating additional questions. 

4. A computer-implemented apparatus for assisting a user in completing a task, 
comprising: 

a set of stored question procedures, one or more of the questions procedures including a 
25 reference to another procedure; and 

means for executing a question procedure that includes a reference to another procedure 
for dynamically generating a question to present to the user, the question procedure cal'.ir^ :! e 
referenced procedure to generate content for the question based on an analysis of one or more 
previous answers given by the user. 

30 5, A computer-implemented apparatus for assisting a user in completing a task, 

comprising: 

means for generating a question for presentation to the user by making a reference to a 
procedure for generating question content that is literally different from but based on an analysis of 
one or more previous answers given by the user; and 
35 means for recording an answer given by the user to the presented question for use in 

generating content for another question. 
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6. A computer-implemented method for assisting a user in assembly of a document 
from a number of possible provisions, the method comprising the following steps: 

storing a set of question procedures, the question procedures seeking data for use in 
generating a provision of a document, one or more of the question procedures including a reference 
5 to another procedure; 

dynamically generating a question for presentation to the user by executing a question 
procedure that includes a reference to another procedure, the question procedure calling the 
referenced procedure to generate content for the question based on an analysis of one or more 
previous answers given by the user; 

10 recording an answer given by the user to the presented question for use in generating 

content for another question; 

repeating the steps of generating questions and recording answers to assemble the 
document with provisions related to the answers given by the user. 

7. A computer-implemented apparatus for assisting a user in assembly of a document 
15 from a number of possible provisions, the method comprising the following steps: 

a set of stored question procedures, the question procedures seeking data for use in 
generating a provision of a document, one or more of the question procedures including a reference 
to another procedure; 

means for executing a question procedure that includes a reference to another procedure, 
20 the question procedure calling the referenced procedure to generate content for the question based 
on an analysis of one or more previous answers given by the user; 

means recording an answer given by the user to the presented question for use in 
generating content for another question; 

means for assembling the document with the provisions related to the answers given by the 

25 user. 

8. A method for creating an application for a computer-assisted decision 
management system, the method comprising the following steps: 

creating a set of question procedures for the application for asking questions of a user, one 
or more of the questions procedures containing a reference to a referenced procedure; 
30 creating a referenced procedure for a question procedure, the referenced procedure 

generating content literally different from but based on an analysis of one or more previous answers 
entered by a user in response to a question, the referenced procedure providing the content to the 
question procedure for use in generating a question; and 

storing the set of question procedures and referenced procedure on a computer-readable 

35 medium. 

9. A computer readable medium on which is stored computer instructions for 
performing the steps of claim 8. 
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10. A computer-implemented apparatus for creating an application for a computer- 
assisted decision management system, comprising: 

means for creating a set of question procedures for the application for asking questions of 
a user, one or more of the questions procedures containing a reference to a referenced procedure; 
5 means for creating a referenced procedure for a question procedure, the referenced 

procedure generating content literally different from but based on an analysis of one or more 
previous answers entered by a user in response to a question, the referenced procedure providing 
the content to the question procedure for use in generating a question; and 

means for storing the set of question procedures and referenced procedure on a computer- 
10 readable medium. 

11. A method for creating an application for a computer-assisted decision 
management system, the method comprising the following steps: 

creating a set of question procedures for the application for asking questions of a user, one 
or more of the questions procedures containing a reference to a referenced procedure; 
15 creating a referenced procedure for a question procedure, the referenced procedure 

generating content for the question based on an analysis of one or more previous answers given by 
a user in response to a question; and 

storing the question procedures and referenced procedure on a computer-readable medium. 

12. A computer-implemented apparatus for creating an application for a computer- 
20 assisted decision management system, comprising: 

means for creating a set of question procedures for the application for asking questions of 
a user, one or more of the questions procedures containing a reference to a referenced procedure; 

means for creating a referenced procedure for a question procedure, the referenced 
procedure generating content for the question based on an analysis of one or more previous answers 
25 given by a user in response to a question; and 

means for storing the question procedures and referenced procedure on a computer- 
readable medium. 

13. A computer-implemented authoring tool for creating an application for a 
document assembly system, comprising: 

30 a computer; 

a block editor stored in the computer for creating blocks for holding data in the form of 
text, references to other blocks and conditional statements, the blocks including question blocks for 
asking questions, answer choice blocks for accepting answers to questions, suggested answer blocks 
to provide suggested answers, question condition blocks to suppress the asking of inappropriate 

35 questions, help and context blocks to hold help or context, processing blocks to hold the logic of 
result processing, fact blocks to hold value assignments, and blocks to manage loop structures; 



WO 99/18500 



-40- 



PCT/US98/21086 



an index stored in the computer for listing blocks created for the application; 

a workspace stored in the computer for entering such data into an opened block from the 

index; 

a selection mechanism stored in the computer for inserting a reference to an indexed block 
5 into the opened biock; and 

a selection mechanism stored in the computer for inserting a conditional statement into the 
opened block, the conditional statement constructed to accept a reference to an indexed block as a 
condition for evaluation. 

14. A method for creating application programs for a 
10 computer-assisted decision management system, comprising: 

placing data including text, block references and conditional statements into program 
blocks, each program block addressable by its unique name; 

placing answer choices for the application program into program blocks; listing the names 
of program blocks on a display for selection; and 
15 selecting and assembling program blocks into a desired order to create an application 

program. 
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